home *** CD-ROM | disk | FTP | other *** search
/ Popular Request / By Popular Request (Arsenal Computer)(SysOptics Distribution System).ISO / amiga4 / toggle10.lha / ToggleDTR / ToggleDTR.doc < prev    next >
Text File  |  1993-10-17  |  3KB  |  105 lines
  1.  
  2.                                ToggleDTR 1.0
  3.                                ~~~~~~~~~~~~~
  4.  
  5.                    (c) 1993 by Marc Heuler (Data Design)
  6.  
  7.  
  8.                            English Documentation
  9.  
  10.  
  11. Disclaimer
  12. ~~~~~~~~~~
  13.  
  14. This  program  (and  all  files  related  to it) are Copyright 1993 by Marc
  15. Heuler (Data Design), all rights reserved.
  16.  
  17.   You may freely distribute ToggleDTR by these conditions:
  18.  
  19.         ╖ Don't take *anything* for copying, except the cost of the media
  20.           itself
  21.  
  22.         ╖ Do not change any of the files related to this program
  23.  
  24.         ╖ Distribute all related files at once, packed into one archive
  25.  
  26.         ╖ German PD-Serials are not allowed to distribute this program
  27.  
  28.         ╖ Fred Fish with his famous software library does *not* have to
  29.           care about all these conditions.
  30.  
  31. This  program  is  "AS  IS",  which  means  you  use it at your *own* risk.
  32. There's no warranty at all.  Please do read the WARNING section.
  33.  
  34. Many thanks to Michael Herold for the inspiration.
  35.  
  36.  
  37.  
  38. Requirements
  39. ~~~~~~~~~~~~
  40.  
  41. This  program  supports  and  requires  Kickstart 2.04 (v37) or higher.  It
  42. works on the internal serial port only.
  43.  
  44.  
  45.  
  46. What is it?
  47. ~~~~~~~~~~~
  48.  
  49. My system often calls out automatically via modem.  The UUCP software I use
  50. sometimes  hangs  on a call.  It then sends error messages until I manually
  51. abort the transfer.  This is very annoying since the call costs money.
  52.  
  53. ToggleDTR  is  the solution to those problems.  I use it to turn of the DTR
  54. signal  for a few seconds when UUCico is spending too much time on a call -
  55. causing the modem to hang up.
  56.  
  57.  
  58.  
  59. WARNING
  60. ~~~~~~~
  61.  
  62. This  program  is  a  *dirty*  hack.  It does access the hardware directly.
  63. These are the things you should know before running it:
  64.  
  65.     ╖ Blindly accesses bit 7 in ciapra of CIA-B to control DTR signal.
  66.  
  67.     ╖ Checks left and right mousebutton for abort using the hardware
  68.       registers.
  69.  
  70.     ╖ Does the inner loop while Forbid()ing multitasking to prevent
  71.       hazardous trouble on the serial port.
  72.  
  73. If you still want to run this program, here's the usage..
  74.  
  75.  
  76.  
  77. Usage
  78. ~~~~~
  79.  
  80. ToggleDTR can be started from CLI/Shell only.  It then takes one parameter:
  81.  
  82.     DURATION/N
  83.  
  84.     Time in milliseconds to drop DTR signal. Default is 1000 (1 sec).
  85.  
  86. To  abort  the  program  while  having  DTR  low, press both left and right
  87. mousebutton.
  88.  
  89.  
  90.  
  91. Author
  92. ~~~~~~
  93.  
  94. Flames  about  the  hardware access go to "NULL:Flame".
  95.  
  96. Otherwise contact me at:
  97.  
  98.         Marc Heuler
  99.         Stephanstr. 6
  100.         D-97070 Wuerzburg
  101.  
  102.         marc@aargh.incubus.sub.org
  103.         +49 931 53295
  104.  
  105.